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ABSTRACT 

A training program for technical vriters^ in vhich a 
specialized information focus is used to ask questions about a text 
in the process of writing and revising^ is the subject of this paper. 
The unique aspects of technical writing are defined according to the 
process whereby readers extract information from text. Reader 
expectations are classified by levels of generality (real world 
knowledge^ grammar^ vocabulary^ and immediate context) and by the 
type of intended audience. Actual samples of technical writing are 
analyzed to show how language options can be skillfully selected for 
the effective presentation of new^ unpredictable information, 
(Author/JF) 
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1* Technical VSrltlng as a Special Text Type 

1.1* It is essential to base training programs in tachnlcal wltlng upon 
a clear avareness of the distinctive featiires of that mode of language use. 
This paper vill argue that teachers of technical /wxltlng should present ar*i 
apply criteria for selecting the options of the language In accordance with 
their function In transmitting Inforraation. 

1.2. Todfly»s students drav on experience vith everyday spoken discourse, 
of^n with substantial features of dialect. Such experience may be more 
of an Interference than a support for technical writing. In the first place, 
speech that Is simply written down Is uucomntunicatlve, deparlTed of such things as 
afi stress, Intonation, facial expression and iinmediate sltmtlon, all of 
vhlch alert the audience about what Infcrmatlon is Important in the message. 
In the second place, the entire organization of speech depends on a distinct 
use of language options not t^ypical of writing. lacking the factors just 
cited as well as thfev opportunity for Immediate feedback, the written text 
muet be so efflcleniay planned that Inforroatlopal priorities woi£Ld be clear 
to at^y reader In the Intended audience* For Instance, greater constraints 
on topic shift must be observec [l}. Syntactic placement jtiust be used to 
compensate for the absence of modulations possible In the spoken voice only 
[2l. The text must be designed on the basis of astute predictions about 
an anticipated reader grouu, rather than upon direct experience provided by 
contact with hearers. 

1.3# Vhat are the features of technical writing as opposed to writing In 
general? Most people would mention at once a special vocabulary based upon 
Latin and Greek [3]. However, technical terms are quite often, neither I*atinate 
nor lenpthy [1*], Whatever special terms are ii^olved, they <u^e readily 
acquired and In fact sijnple to use, ulnce their meaning and hence their 



information content is clearly established for all readers in the field* 
Our students can consult the published manuals for special areas such as 
chemistry, physics, etc* Much greater care is needed with terms that have 
npt only specialised meanings but ordinary meanings: a writer can easily 
confuse the reader by carelessly using the latter in the wrong context* For 
instance, an article on electrcmagnetiem, optics, or binary mathemayics 
should be careful about using '*field" in sane commor^Jlace meaning likeV. 
'^profession" or "area of research*'* Hence, all non -distinctive, infoonnationally 
important terms must be place in clearly determinate contexts * 
l*li* Some linguists [5,61 have tried to define technical texts ty 
internal grammatical features* However, as I have nhown in detail else* 
where [7], the featiires of technical witing may in fact be quite 
similar to those of other text types, even poetry* What is different is 
something l-shall"^call "irifcr"roatlbnal Tg^^ specifically 
designed for each individual text type* The focus for poetry registers 

other featiires than that for technical writing:^ in accordance vith 

/ 

V 

distinct ct^gnitive priorities* 

2* The Informational Focus and Technical Siting 

2<1* It would be useful to agree upon a definition of information* In 
information science, the informational value of any element is computed 
according to the probability of that element's occurring where it does 
[8]* If one has a language with an exactly defined number of choices ^^t 
any point — for Instance, a synthetic formal language — one can rely on 
precise stati^tics^ But a language such as standard written English has 
no such exact lu. ,j.tation3 upon entropy, i*e* the number of alternative 
messages* Hence, we must replace statistics with our shared frameworks 
of expectations about vjhat is normal in various contexts* We shall then 



v±ev the reader not as an abstract machine processing Input, but as a 
member of our society vho shares our experience and uses the latter to 
predict ^jhat texts are talking about. Experiments in reading [9, P,??] 
show conclusively ^hat "readers* language canpetence enables them to 
create a graimnatlcal and semantic predlctloa In uhlch they need only a 
sample from print to i\each meaning.** In artif IciaX Intelligence models 
[such as 10], the material used readers In ccurporehendlng texts by 
prediction Is aeen as "default assignments*' grouped In a^fl^ame.*' T'Jhen 
the readers psrcelve seme material that matches a given Crame, they are 
quite likely to make large-scale predictions unless clearly alerted .by 
further material that fails to match. It is precisely for this reason 
that contexts determine so strongly hofvr a term ^11 be understood (see 

_ above), Vi*itea:5,_J3n._the other hand, know^vhat-they rasan-ln- advance and -- 

tend to overlook potentially rftisleadlng cotttoinations: their "Crajsies" 
are selected in advance, vhile the readers must make a selection only 
after searching the text itself. Obviously, what writers mean to say is 
of no ir^portance vh«n the material on paper allows alternate, unintended 
but non^otheless platLSible, interpore tat ions. Yet our students have been 
conditio led lyfaceHo-face speech, vhere one has many chances to restate 
things again and again; In fact. It Is considei^ed bad manners to ask for 
explanation as long as the meaning "somehovr gets across,** And of course, 
knowing one's hearers and speakers allows one to ittake good predictions, no 
matter what they are talking about, 

2,2, It follows ^'om the foregoing considerations that students must be 
trained to evaluate vhat they write on the basis of how veil the readers 
will be guided correctly and efficiently In getting the important Informa" 
tlon from the text. The problem Is that the writers fall victim to their 
cwn set of frames vhen they turn readers* their flrst-4iand knowledge of 



what the Information Is supposed to be makes th^ blind for the 
difficulties uhat those without such knowledge may encounter* To OTrerccsne 
this effect, the teaching of technical writing should provide training 
In the use of not the conventional Information focus, but a specially 
conditioned focus that detects and solves problems^ The basic technique . 
to be considered hsre Is used both In artificial Intelligence models [111 
and psychological Information tests [reported In 12] and consists of 
Inserting questions Into the text* 

3* A Specialized Focus for Technical Witers 

3#1'> The first thing a vriter must ask is; vhat Is beliig presupposed and 
expected of anyone vho wants to read the text? It Is useful to subdivide 
this question into various levels of" Vxprc^Eatior^^ "a^aressea"^ 
in a text* In any society, readers agree about ^Jhat is normal In the 
"real vorld," that Is, in the accepted model of the human environment ^ 
Obviously, not all Input from the environment Is considered Information 
worth attending [13,. p* 202ff^]^ By deciding to attend to only certain 
Infarmatlon, people make It very easy to react in **normal" situations and 
to understand '»Tiannal" language samples* In addition, speakers of English 
vlll largely agree about '*^at kinds of grammar arid what vocabulary Items 
are 1) normal In English, and 2) acceptable In familiar text types* For 
exajJ5)le, sonie technical wltors have recourse to long, unfamiliar vwds 
irtilch aren't at all necessary, simply because they assume such worias to 
be expected In technical vrltlng# Finally, there are e^spectatlons created 
within the text Itself, which are often matched to the two lervelr just 
mentioned, but which can be very powerful on their own and override the 
others* Thus wlters must ask themselves the question about expectations 

on at least three levels: 1) "real i^orld knowledge" (sometimes called also 



"common sense krioftjledge" , 2) graionar ana vocabiilary, and 3) vhat fits in 
the ftnamework of the text at hand* 

3#2# In the case of technical material, the first leirel is directly 
decided by the basic knowledge in that area of stu<%y^* However, an 
important distinction must be made right auay; are the readers familiar 
vith the area, or is the witer going to introduce them to it? Only in 
the former case can witers presuppose ar^sr specialized kTV>wledge* In the 
latter case, -writers must foresee problems and misunderstandings Which 
they themselves could never encounter* And what of the scientists who sTe 
tiyitig to g^in some knowledge in a neighboring area outside their 
specialization? Can a writer afford to exclude them by insisting upon 
insider»e jargon and veiy detailed presuDpositions? Not inany of our 
students are likely to be able to afford this in their later careers — 
quite aside frcan the basic issue of courtesy being violated* Witers 
who consistently ask themselves what information is needed to understand 
a given passage could alvays make the specialized knowledge accessible, 
at least by clear references to relevant sources* In this way, the 
differences in previous reader training are less crucial, and the writers 
reach a larger audience* 

3*3* A similar attitude should be maintained at the level of selecting 
vocabulary* Purely decorative t&ms must be rejected in favor of terms 
whose informational content is quickly and unambiguously discoverable* 
For inrtance, referring to a technical device w principle simply by the 
name of the original inventor is wholly iminfonnative for itiany possible 
readers and should be accompanied either by references or better still, 
by a brief explanation* It is discourteous to make readers run to the 
dictionary or to the library when the difficulty the topic doesn*t 
really require* it* As a professional linguist doing research in psychology, 
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I am inconvenienced when a very wr^hwhile book such as [lU] Introduces 
Trithout the slightest explanation such thitjgs as ^*a Poiason variable" 
[p. 131], a »»Wewnan-Keu\s procedure" [p* 160} or a '»Euler constant" [p. 191]* 
Siirely statisticians are not so utterly desperate for terms that people's 
names must be tised instead of self-explanatory vordsl 
3#Tu Vocabulary selection is also ijnportant because it creates contexts ♦ 
Readers expect to find terms selected\£ram a coherent area of discourse, 
not a Jxmble of terms frm chemistry, a^atC!!T^y, newspapers, and poems* Yet 
all too often one finds jumbles of Just this kind, because writers are not 
askihg themselves the question* What area is this term from, and does it 
fit the othOTO I*m using? Only writers vho do this vill see How much , ' 
confusion can arise from using the same vord in, a technical sense and then 
in an everyday sense, as already mentioned* 

3*?* The options of grammar, as I suggested before, are even more vital 
considerations in writinc than in speech* In writing, the information which 
vocabulary items can contain must after ain>e organized according to 
the priordLties of that particular topic and of the point to be made* For 
example, donsider these two sentences appearing in a textt 

(1) Einstein solved this important prdblem also* 

(2) This important problem was also solved ly Einstein. 

Only one word has been added to (2), and the active replaced by the passive* 
Yet the first sentence would only be effective in a passage talking mostly 
about Einstein, and the second only in one talking about the problem* The 
questions which the students could be directed to ask, for the samples must be 

(3) ^Jhat else did Einstein solve? {for number 1) 
(Ij) Who else solved the prdblcm? (for number 2) 

There are. of course more options for still greater emphasis. Suppose that 
it >jere not expected to have Einstein mentioned here at all* Then one could 
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U85 the so -called" clef ti' s.entence beginning vith '^it'» plus a itarm of **be": 

(5) It was Einste^ (hlmselt) who solved tMB problem* 

(6) It was none other than Einstein "^-ho' solved this problem. 

The additional elements further address presupposed^ inf armation. If ve write 
|<hljnseir*, we presuppose the ''real world knowledge'' than Einstein was a very 
important person. If we write ''none other than'* we pa*esuppose this same 
thing and also that the readers wouldn't ejcpect Einstein to hava achieved 
the task mentioned. If readers laay know that someone solved the problem, 
but be in doubt about the person's identity, - a different type of "cleft" 
sentence will serve: 

(7) Einstein was the one Trtio^ solved the problem* 

Thtee sp€teial placements are surveyed jn Cl5, pp. 169-85]. They cause a 



shift of focus for readers in which attention Is redistributed toward the 
^ items wlHch tHe writer considers important. If such placeinents are overused, they 
soon lose their effect, becoming themselves the normal state of things. 

U. Applications of the Method 

- - - ' c 

li*l. I^have nat_yet assembled all of the criteria for efficiently 

- _ ._ ^# 
evaluating the various kinds of information employed in processing texts 

^ ' (to be later set forth in[Jj6]}. Howavor, it does seem elear what the 

main types of questions are that readers should ask themselves concerning 

what is expected of a reader audience. I would like to apply the method 

I have outlined to seme actual samples of technical writing^ hoping that 

Illustrations my serve to justify the theory advanced this far. 

li*2. First, let us consider the is^ue of the relationship of sentence 

order and grammar to information in this text t 5, P« 1211: 

(8) Dietl^l ether has been reported to stiimilate respiration 
Diethyl ether in constant concentration was administered' thrcAigh a 
non-return system* Expiratoiy v >lume was measured with a Wedge 
chronometer. 

er|c ' 



Aside from possibly unfamiliar terijis, this text is clear and easy to read. 
Why? The information content is arranged in sucft a vay that the normal 
positions for new information (the later part of the sentence) and for 
stated or Implied information (the early part gf the ^ntence) have been 
closely observed* Since the first sentence mentions diethyl ether and what 
it has J^^n "reported" to do (I omitted the references here), the readers 
assume that some cojnpWible experlAent will be described* The second 
sentence neatly confirms that expectation by taking the sajite item, ''diethyl 
ether,** as its starting point* The third sentence begins with ^expiratory 
volume," which is implied information, being a logical coar^onent of the 
more general ^respiratiori" in the first sentence* We notice that the passive 
has been selected as the grammar option most suited to an effective 
distribution of information* It would be less noiml for the second sentence 
/to uso an active construction naming ■'ohe (here not relevant) agentt 

(9) X administered diethyl ether in constant concentration, ♦ ♦ 

This sentenbe fits the question "what did I administer?", which need hardly 
be asked at all after the first sentence created strong esqpectations* But' 
if a non-expected substance had been used, the writer could well sayt 

(10) Instead, we administered ethyl alcohol in constant concentration, ♦ 
-I ^ 

This sentence has focu3 on the substance plus the signal "instead" which tells 

readers to revise their expectations* Wow, our sajjq&le Is interested in 
getting two things across; the conditions under which the (expected) substance 
was administered (sentence 2) and what measurdftents were taken (sentence 
three)* Notice that the latter positions of the sentences are used here* If 
students read them aloud, evwyone will heaij that the highest stress point 
falls on this very information [cf* Therefore, the passive is often 

motivated in technical writing ty the^ desire to focus on procedures and 
data (rather than upon the researchers as agents) and to add to the known 
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information step tjy step^ Wo gaps are left in this text other than the veiy 

logical transition from vhole to part ("respiration* , , expiratory volunie**). 

If the chronometer must be a special type, it vcf\ild be better to cite the 

essential characteristics rather than a person^s name ("^fedge")^ 

U,3, I mentioned already the vital distinctions between non -specialist and 

specialist reader audiences. This sample of technical vriting f or" non* 

specialists is veiy instnictiTei 

(H) Mweguide systems are often loosely called **pli^iiie/ The name 
implies a nettTork of empty pipes where electrical energy flows . , 
unimpeded. Actually, a waveguide is a po^eclsely-designed, electrically- 
tuned structure for propagating electrcTiagnetic waves. It transmits 
certain determinable frequencies well, does not transmit some frisquencies 
at all, and transmits others only with large losses [l8,^p^ U8] • 

This text also begins with the main topic right away: "waveguide systems^" 

The subjects of all the following sentences return to this information: 

"the name," "a waveguide," and "it," The passive figures only in the first 

sentence^ since the topic "wveguide" can and does figure as agent later on,^ 

The new information falls unifcrmly in the predica+a^ To account for the 

readers* non-specialize^ background, the Uttfamiliar object "waveguide" Is 

right away set in metaphoric relationship to the familiar "plumbing,". The 

metaphor is a device depending upon the shared properties of things [19J, 

The writer thus goes on to state what properties are shared by the unfamiliar 

atid the familiar items in this casei "network, , ^plpes, , , flows," However, 

the witer warns the readers that the two itejns are not identical by signals 

of reservation; "loosely, , , implies, * ,actually," In this vay, known 

information of readers is addressed, but the readers are irr^eHed to modify 

'the frames which have just bv.en called upon. The modifications allovf the 

integration of the ways in which "waveguides" are not "plumbing^': 

"precisely*iJesigned, electrically^uned, " intended for a special purpose 

C"propagatin^^"eifeo4ramagnetic waves") with special limitations upon what th?y 

12 .. ■ ■ - 

( ' ^ 



10 



can transmit {last sentence). In other words, the new item is first given 
scjne general formal reseirblance to a known item and then differentiated from 
the latter by a definition of its operation ^ Wo specialized terms are used 
at all, expsct the main item '*waveEuide Even this is self^^qjlanatory; 
it guides raves. The operation Ijg riada especially clear tjy repetition and 
erammatical parallelism; the siibject *'it" is retained in threo clauses, 
'the verb "transTnit" repeated three times, and thQ direct object Is in 
each case some mernbers of the same large class of "*frequencies," The 
differences in frequencies are not yet vital. The fact that these differences 
exist i£, however, and the general similarities within the last sentences 
allow the differences to emerge with special force, like raised objects 
- against a flat^ background. This information is added in small steps, and 
neither special knovrledge nor extensive Inferences are required. 
In contrast, here is a text far specialists; 

(12) The glycolytic system of Ehrlich ascites cells, with all. enzymes 
of the pathway present in proper amounts and with appropriate reverse 

, reactions, T«jas simulated by a ccauputer model, derived fi^ previous work 
[**•] by adjustment of numerical values and inclusion of missing reactions, 
thjunerlcal constants are determined from the experimentally observed 
inhibited^* steady state (with excess glucose) and then adjusted so 
that the model will also hold the observed endogenous steady state 
and follow the observed transient kinetics [..J When glucose is 
added to resting cells, [5, p, 119] 

Obviously, the text -sould not be reaa by people unacquainted with micro- 
biology. But several professors of microbiology, including some experts in 
virology,^ found the text hard to read, even tfiough they understood it. 
What questions does the te3cb answer and what others are left uncleaj;?^!^ 
special terms must be recognized, A "glycolytic system^* describes how cells 
use glucose either by s^theslzing it or formjjig other products from itt 
hence "reverse reactions*' are. In theray at least, always possible. The , 

' 1 I am indebted to Prof, David A, Wolff of. the Ohio State University for 
his interest and help. 
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reactions in either direction must follow '^thvmjrs" of steps that one could 
veil simulate on a computer* Anyone at all interested in this report vould 
have to asln* how does one set up the model, and how is the model like or not 
like the real thiUR? As ve shall see, the text leaves the answers to this 
questions unclear* 

li*?* The key term "Ehrlich ascites cells" is known to most microbiologists, 
but jajf survey showed that it wuld indeed bp both considerate and useful 
if this writer had reminded readers about iihat is involved; tumorous cells 
floating in ascitic fluid that accumulates in the abdominal region of aalmals* 
The use of the person's name who first_ studied the-cells is rather unen* 
lightening* Now, this text deals vith simulated models, not vith real 
cell reactions* We are slJiiply told that the data from a cited *ource 
{the first omission in sample) ms "adjusted" and lhat reactions which 
must have been "missing" in reality but were needed for unspecified 
reasons,, vere "included*" One must not only run to look up the "prefvious 
worl^f'not even summarized here; one still wouldn't know how things looked 
after the "adjustmoits*" There are two "stea<%y^ states" mentioned in the 
second sentence, one, of them normal to the system {''endogenous") and one 
somehow different because of being "inhibited*" One notes the unexplained 
use of <}uotation marks, suggesting some ppssible metaphort what is the 
difference between being inhibited and being "inhibited"? And was the 
state ^evented from occurring or frcan changing? respondants all agreed 
that the questions raised above are not solved Iqr the text, nor are the 
answers readily obvious, eVen to specialists* 

2 T^nn^nology in microbiology and virology is^ chaotic* Types of cells or 
viruses are named after researchers \it\o isolate them or after the towns or 
even the individual people in which saii5>les were first found* Wo one could 
tell me for sure which is true here* Perhaps the name conies from the 
eminent bacteriologi<it Paul Ehrlich {I8$li-l9l?) * But aside from a possible 
date implied in his discovery, m still wouldn't learn -arQTthing from that* 



h,6. By the standards I suggested before, sample (12) is not well planr.e^. 

Readily predictable reader questions are not dealt with effectively. The 

sentences are lonf and clumsy, and teriainoiogy either vague or needlessly 

complete. Let us compare a revision of the same te:ct with the original: 

(13) The glycolytic reaction systems of tumerous cells in abdominal 
ascites fluid >ras sinulated by a computer model. The model* which 
included proper acnoants of enzymes in the pathvajr and allowed for 
reverse reactions, vas obtained by modifying the data in 
as follOT'TS: [,,,],Using observations of real experiments, 
derived numerical constants for: 1) the endogenous' atea^fy state, 
2) a steady state artificially induced with excess |[|||ose, and 
3y the rates at vhich resting cells react to added glucose. 

This version begins with a clear statement of the topic, suitable for a 
wider reader audience than iv^as the case in the original. Hew information 
is added step by step Tri,th known information followed by ne^j. Sentences 
are short in order to keep these steps distinct, V/hen the agent "we^^ is 
crucial in sho^dng who created the ^*constants" in question, it is used 
instead oi ohe passive of the original. Specialised terminology has been 
replaced ^jith terms accessible to any biologist. In shcart, this version is 
easy to read because possible reader problems are anticipated and non- 
ambiguous answers are provided. Notice that clarity and courtesy do not lead to 
sacrificing that brevity which editors of technical journals admire so much: 
the original has words and my version ?he witer might use the saved 
space to clear up just what those "adjustments'* and '^inclusions'* would 
mean for the applicability of the model to the real thing, 
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